home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / rem_acc / dctcl005.zip / DCTCALL.TXT < prev    next >
Text File  |  1996-05-26  |  15KB  |  333 lines
  1.       ▄▄▄▄▄▄ ▄▄▄▄▓▄▄▄▄▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ ▄▓▄▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  2.   ▄▄██▓█▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀ ▀▀▀▓▀▀ ▀▀▀▀▓▀▓▀▀▓▀▀▀▀▀▀▀▀▀▀▀ ▀▀▀▓▀▓▀▀ ▀▀▀▀▀▀▀▀▓███▄
  3.  ▐█▓▀                                                                    ▀▓█▌
  4. ■█▓                             DCTCall v0.05                              ▓█
  5.  █                      For RemoteAccess 2.0x or 2.5x                      ■█
  6.  ▓■                           By Dan Traczynski                             ▓
  7.  ▒░                             May 26, 1996.                               ▒
  8.  ░                                                                          ░
  9.         Copyright (C) 1995..1996 Dan Traczynski.  All rights reserved.
  10.  
  11.  ▒▄▄▓▄▄▄▄▄█▄ ▄▄ ▄▄▄▓▄▄▄▄▄▄ ▄▓▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▓▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▓▄▄▄▄▄▓▄
  12.   ▀▀  ▀▀▓ ▀▀▀▓▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▓▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▓▀▄▒▀
  13.  
  14.  
  15.    This package contains two utilities, one a door which displays a "Today's
  16. Callers" listing to your users, and the other a simple utility to edit your
  17. LASTCALL.BBS file.  The program will work with RemoteAccess 2.0x and 2.5x.
  18.  
  19.  
  20.            ■▒▄ ▄▄▓▄  ▄▄▓▄▄▄▄■         ▄ ▄▄▄▄▓▄    ▄▄▄▓▄  ▄▓▄
  21.         ▄▀▄▓▓█░██▄█▒█▀▒█░█▓███▄▒█▀▒█▄█░▄██░▒██▓▀█▒██▀▒██░█▄██▒▓▄▓▀▄
  22.           ■ ▀■▀▒ ■▀▓▀ ▀▀ ▓▀▀■ ▀▓     ▀▓▀▀▄▀▓▓▀ ▀   ▄ ▀▀▓▀▄■▀ ▀▓
  23.  
  24.                             TaBLe oF CoNTeNTS
  25.                           ─═══════════════════─
  26.  
  27.                Features ................................... o1
  28.                Installation ............................... o2
  29.                Customization .............................. o3
  30.                SysOp Hotkeys .............................. o4
  31.                The LASTCALL.BBS editor .................... o5
  32.                Distribution & Disclaimer .................. o6
  33.                Credits/Acknowledgments .................... o7
  34.                History - Notes from the Past .............. o8
  35.  
  36.  
  37.  
  38.            ▄  ▄ ▄▄▓▄  ▄▄▓▄▄▄▄    ▄▄▓▄  ▄ ▄▄▄■▄     ▄▄▄▓▄  ▄▓▄ ■
  39.           ▀▄▓▓▄░█░▄▒██░▀█▒█░█▓█▄▒█▀▒███░█▒▓█▒██▒▀█▒█░▄█░██▀▒█▓▄▓▄▀■
  40.          ■  ■▀■▀▒ ■▀▓▀ ▀▀ ▓▀▀■ ▀▓     ▀▓▀▀▄▀▓▓▀ ▀   ▄ ▀▀▓▀▄■▀ ▒▀
  41.  
  42.                     SeCTioN o1 «≈» Features of DCTCall
  43.                   ─════════════════════════════════════─
  44.  
  45.              ■ Supports both RA 2.0x and 2.5x.
  46.              ■ Fully customizable.
  47.              ■ ANSI and ASCII support.
  48.              ■ Can list only the last x callers.
  49.              ■ Fast & easy setup.
  50.              ■ User time-out after 120 seconds.
  51.              ■ Multinode capable.
  52.              ■ Multi-tasker capability.
  53.              ■ Internal SysOp-User chat mode.
  54.              ■ Carrier detect.
  55.              ■ Includes a utility to edit your last callers list.
  56.              ■ It's FREEWARE!
  57.  
  58.  
  59.            ■▒▄ ▄▄▓▄  ▄▄▓▄▄▄▄■         ▄ ▄▄▄▄▓▄    ▄▄▄▓▄  ▄▓▄
  60.         ▄▀▄▓▓█░██▄█▒█▀▒█░█▓███▄▒█▀▒█▄█░▄██░▒██▓▀█▒██▀▒██░█▄██▒▓▄▓▀▄
  61.           ■ ▀■▀▒ ■▀▓▀ ▀▀ ▓▀▀■ ▀▓     ▀▓▀▀▄▀▓▓▀ ▀   ▄ ▀▀▓▀▄■▀ ▀▓
  62.  
  63.                        SeCTioN o2 «≈» Installation
  64.                      ─═════════════════════════════─
  65.  
  66.    If you are upgrading DCTCall from v0.04, simply overwrite the old .EXE
  67. files with the new ones.  There were no data file changes.  If you are
  68. upgrading from a version prior to v0.04, it would probably be best to simply
  69. delete all of the old files and re-install the new version.
  70.  
  71.    Before installing DCTCall, create a separate directory for it and move the
  72. files there.  To create the configuration file, run CONFIG.EXE and configure
  73. it to your system.  Once completed, create a type 7 option from RA and use
  74. a command-line similar to "C:\RA\DOORS\DCTCALL\DCTCALL.EXE /PC:\RA".  Memory
  75. swapping should not be required.
  76.  
  77.    The "/P" parameter specifies the directory where the drop file may be
  78. found.  An optional "/Zx" parameter may also be used which will have DCTCall
  79. list only the last x callers.  Simply specify something like "/Z10" to list
  80. the last 10 callers or whatever number you wish.  LASTCALL.BBS will be found
  81. using your RA environment variable.  Be sure to check out SAMPLES.ZIP as you
  82. may wish to use a different listing style than the default one (or create your
  83. own).
  84.  
  85.  
  86.            ▄  ▄ ▄▄▓▄  ▄▄▓▄▄▄▄    ▄▄▓▄  ▄ ▄▄▄■▄     ▄▄▄▓▄  ▄▓▄ ■
  87.           ▀▄▓▓▄░█░▄▒██░▀█▒█░█▓█▄▒█▀▒███░█▒▓█▒██▒▀█▒█░▄█░██▀▒█▓▄▓▄▀■
  88.          ■  ■▀■▀▒ ■▀▓▀ ▀▀ ▓▀▀■ ▀▓     ▀▓▀▀▄▀▓▓▀ ▀   ▄ ▀▀▓▀▄■▀ ▒▀
  89.  
  90.                        SeCTioN o3 «≈» Customization
  91.                      ─══════════════════════════════─
  92.  
  93.    To customize the format and colours of DCTCall, you must edit the
  94. DCTCALL.STL file, which is divided into a few different sections.  The first
  95. one is the "declaration" part, which tells DCTCall what the pause prompt
  96. should look like and some other information.  Valid declarations are shown
  97. below.
  98.  
  99.  NewColour <n>          This states what colour new users are to be displayed
  100.                         in when showing how many calls they made.  Valid
  101.                         range is 1 to 15.
  102.  
  103.  PausePrompt <String>   Use this statement to set what your pause prompt at
  104.                         the end of each screen should look like.  If no pause
  105.                         prompt is declared, the internal animated one will be
  106.                         used.
  107.  
  108.  NoBanner               This simply disables showing the copyright info line
  109.                         at the bottom of each page (instead it is displayed
  110.                         when the program terminates ;).
  111.  
  112.    Once you have completed this part, you must make the "header" section which
  113. is what is displayed at the top of the screen above the listing.  Simply add
  114. the word "Header", then insert the lines containing the header below it.  An
  115. example is shown at the end of this chapter.
  116.  
  117.    Once you have designed your header, you must create the body of the
  118. listing, which is referred to by the keyword "Main".  This is the actual
  119. list format that will be used.  Imbedded codes are to be used in this section
  120. to display the caller's name, baud rate, etc.  Refer to the table below for a
  121. list of available codes in this section.
  122.  
  123.         List of imbedded codes
  124.    --------------------------------
  125.      %B         Baud
  126.      %Cx      ~ Calls
  127.      %Nxx     ~ Name
  128.      %1A        Time On, hours
  129.      %1B        Time On, minutes
  130.      %2A        Time Off, hours
  131.      %2B        Time Off, minutes
  132.      %Tx      ~ Time spent online
  133.      %Lxx     ~ Location
  134.      %Ox      ~ Node
  135.      %#         Caller Number
  136.  
  137. ~ The "x" or "xx" in these codes are the length that the field should be when
  138.   printed on the screen.  Therefore a "%N30" would display the user's name
  139.   with spacebar padding to make it 30 characters.  The rest of the fields are
  140.   always of a fixed length.
  141.  
  142.    To wrap up the design, a footer section is to be created.  It is basically
  143. what is displayed at the bottom of the screen after the users have been
  144. listed.  An example follows.
  145.  
  146. ────────────────────────────[ Sample DCTCALL.STL ]────────────────────────────
  147. NewColour 15
  148. PausePrompt [PauSeD]
  149. NoBanner
  150. Header
  151. -------------------------------------------------------------------------
  152. Name                         Login Logout Location                   Baud
  153. ---------------------------- ----- ------ -------------------------- ----
  154. Main
  155. %N28 %1A:%1B %2A:%2B  %L26 %B
  156. Footer
  157. -------------------------------------------------------------------------
  158. ──────────────────────────────────────────────────────────────────────────────
  159.  
  160. This design would translate to something like:
  161. ──────────────────────────────────────────────────────────────────────────────
  162.  
  163. -------------------------------------------------------------------------
  164. Name                         Login Logout Location                   Baud
  165. ---------------------------- ----- ------ -------------------------- ----
  166. Dan Traczynski               12:07 12:47  Vancouver, B.C.            28.8
  167. System Operator              12:49 13:04  Vancouver, B.C.            None
  168. -------------------------------------------------------------------------
  169.  
  170. [PauSeD]
  171. ──────────────────────────────────────────────────────────────────────────────
  172.  
  173.    Of course you are free to add ANSI codes to this and it will work just as
  174. well.  Please see the examples in the archive SAMPLES.ZIP for more help on
  175. designing your own styles.
  176.  
  177.  
  178.            ■▒▄ ▄▄▓▄  ▄▄▓▄▄▄▄■         ▄ ▄▄▄▄▓▄    ▄▄▄▓▄  ▄▓▄
  179.         ▄▀▄▓▓█░██▄█▒█▀▒█░█▓███▄▒█▀▒█▄█░▄██░▒██▓▀█▒██▀▒██░█▄██▒▓▄▓▀▄
  180.           ■ ▀■▀▒ ■▀▓▀ ▀▀ ▓▀▀■ ▀▓     ▀▓▀▀▄▀▓▓▀ ▀   ▄ ▀▀▓▀▄■▀ ▀▓
  181.  
  182.                        SeCTioN o4 «≈» SySop Hotkeys
  183.                      ─══════════════════════════════─
  184.  
  185.            F1    ·Shows the Sysop keys on the status bar.
  186.            Alt∙C ·Invokes the chat mode.
  187.            Alt∙T ·"Twit user".  Returns the user back to the BBS.
  188.            PgUp  ·Adds 5 minutes to the user's time.
  189.            PgDn  ·Subtracts 5 minutes from the user's time.
  190.  
  191.  
  192.            ▄  ▄ ▄▄▓▄  ▄▄▓▄▄▄▄    ▄▄▓▄  ▄ ▄▄▄■▄     ▄▄▄▓▄  ▄▓▄ ■
  193.           ▀▄▓▓▄░█░▄▒██░▀█▒█░█▓█▄▒█▀▒███░█▒▓█▒██▒▀█▒█░▄█░██▀▒█▓▄▓▄▀■
  194.          ■  ■▀■▀▒ ■▀▓▀ ▀▀ ▓▀▀■ ▀▓     ▀▓▀▀▄▀▓▓▀ ▀   ▄ ▀▀▓▀▄■▀ ▒▀
  195.  
  196.                SeCTioN o5 «≈» Editing Your LastCall.BBS File
  197.              ─═══════════════════════════════════════════════─
  198.  
  199.    I have included a utility in this package which allows you to edit the
  200. LASTCALL.BBS file, therefore allowing you to edit who called that day.  I
  201. suppose that the only possible use for it would be if you had unwanted users
  202. abusing your BBS and creating bogus accounts, you could use the utility to
  203. easily delete these entries from the caller file.  Or you may just want to
  204. see who called that day without entering the BBS - it can be used for that as
  205. well.  The program is quite easy to use, so I doubt anyone would encounter
  206. any problems when using it.  The only point to mention is that if EDITCALL.EXE
  207. can't find your LASTCALL.BBS file it means that you haven't set your RA
  208. environment variable.
  209.  
  210.  
  211.            ■▒▄ ▄▄▓▄  ▄▄▓▄▄▄▄■         ▄ ▄▄▄▄▓▄    ▄▄▄▓▄  ▄▓▄
  212.         ▄▀▄▓▓█░██▄█▒█▀▒█░█▓███▄▒█▀▒█▄█░▄██░▒██▓▀█▒██▀▒██░█▄██▒▓▄▓▀▄
  213.           ■ ▀■▀▒ ■▀▓▀ ▀▀ ▓▀▀■ ▀▓     ▀▓▀▀▄▀▓▓▀ ▀   ▄ ▀▀▓▀▄■▀ ▀▓
  214.  
  215.                  SeCTioN o6 «≈» Distribution & Disclaimer
  216.                ─══════════════════════════════════════════─
  217.  
  218.    DCTCall is copyrighted (C) 1995, 1996 by Dan Traczynski.  All Rights
  219. Reserved.  I encourage you to distribute it, but DO NOT by any means change
  220. any of the files within the original archive.  The archive should be named
  221. DCTCL005.ZIP, preferably kept in its ZIP format.
  222.  
  223.    The author, Daniel Traczynski, will take no responsibility should any
  224. unintended results occur to your system while using this program.  Although
  225. this program has been tested thoroughly, no guarantee can be given that it
  226. will do what it was made to do.  Nevertheless, if anything should happen, the
  227. user is totally responsible and the author will be under no obligations
  228. whatsoever.  By using this program you agree to this disclaimer.
  229.  
  230.  
  231.            ▄  ▄ ▄▄▓▄  ▄▄▓▄▄▄▄    ▄▄▓▄  ▄ ▄▄▄■▄     ▄▄▄▓▄  ▄▓▄ ■
  232.           ▀▄▓▓▄░█░▄▒██░▀█▒█░█▓█▄▒█▀▒███░█▒▓█▒██▒▀█▒█░▄█░██▀▒█▓▄▓▄▀■
  233.          ■  ■▀■▀▒ ■▀▓▀ ▀▀ ▓▀▀■ ▀▓     ▀▓▀▀▄▀▓▓▀ ▀   ▄ ▀▀▓▀▄■▀ ▒▀
  234.  
  235.                   SeCTioN o7 «≈» Credits/Acknowledgments
  236.                 ─════════════════════════════════════════─
  237.  
  238. -Well I'd like to thank Alan Ianson (BBS: 604-251-1817) for his support of all
  239.  my programs; without him my software wouldn't have been hatched into the
  240.  RADist network.  His FidoNet node number is 1:153/757 in case you would like
  241.  to FREQ any programs from him.
  242. -Steve Lorenz for DDPlus.
  243. -Chronos on Rogue's Inn BBS for ßeta testing the program for me back when it
  244.  was only a ßeta 1.  Too bad his board went down.
  245. -Garfield on Neural Meltdown BBS (604-255-5198) for his ßeta testing.
  246.  
  247.  
  248.            ■▒▄ ▄▄▓▄  ▄▄▓▄▄▄▄■         ▄ ▄▄▄▄▓▄    ▄▄▄▓▄  ▄▓▄
  249.         ▄▀▄▓▓█░██▄█▒█▀▒█░█▓███▄▒█▀▒█▄█░▄██░▒██▓▀█▒██▀▒██░█▄██▒▓▄▓▀▄
  250.           ■ ▀■▀▒ ■▀▓▀ ▀▀ ▓▀▀■ ▀▓     ▀▓▀▀▄▀▓▓▀ ▀   ▄ ▀▀▓▀▄■▀ ▀▓
  251.  
  252.                       SeCTioN o8 «≈» Program History
  253.                     ─════════════════════════════════─
  254.  
  255. v0.05 - May 26, 1996.
  256.  
  257. This is the first public release of DCTCall to RADist.
  258.  
  259. -Added the animated pause prompt.
  260. -Fixed a bug in style #5.
  261. -Added the %T macro (shows how many minutes the user spent online).
  262. -EditCall.Exe would not let you change the time on and time off fields.
  263.  Fixed.
  264. -Modified sample styles #1 and #4 so they would use the new macro that
  265.  displays the minutes the user spent online.
  266. -If the user had ASCII and a new user (someone with 1 call to the system) was
  267.  in the caller list, DCTCall would send ANSI codes across the modem.  This
  268.  is fixed (thanks Alan, I never would have found this!).
  269. -Improved EditCall.Exe.
  270. -Replaced style #2 with a new design.
  271. -Added a 120 second user timeout.
  272. -Fixed up the colour configuration in CONFIG.EXE.
  273.  
  274.  
  275. v0.04ß - March 13, 1996.
  276.  
  277. -Added listing style #5.
  278. -The "Paused" prompt may now be configured.
  279. -DCTCall can now be configured to list only the last x callers.
  280. -Fixed the colour of the "New" string in the number of calls for good this
  281.  time.
  282. -Added the configuration program.
  283. -Added colour configuration.
  284. -Rewrote the documentation.
  285. -Added the LASTCALL.BBS editor.
  286.  
  287.  
  288. v0.03ß - February 5, 1996.
  289.  
  290. Well it's been a while, but I finally decided to finish off this new version.
  291. As soon as I'm sure that it's bug-free, I'll make a public release of it in
  292. RADist.
  293.  
  294. -Fixed a bug where the caller number wasn't being sent over the modem and
  295.  would only display locally.  This was a really stupid mistake, but the
  296.  program works fine now.
  297. -Fixed a bug in the "Returning to BBS" display on the remote end when the
  298.  listing was completed.
  299. -Fixed a bug where if the caller had 0 calls the colour would screw up (but
  300.  it's impossible to have 0 calls unless the SysOp edits the user).
  301. -DCTCall now displays 31200 and 33600 baud as RA 2.50 now supports these.
  302. -If you had the status bar turned off and hit F1 to display the help, it
  303.  would go back on.  Fixed.
  304. -You can now keep DCTCALL in its own directory rather than RA's and it will
  305.  still function correctly (simply use "C:\BBS\DOORS\DCTCALL\DCTCALL.EXE" as
  306.  the command line).  LASTCALL.BBS must be in the current directory though.
  307.  
  308.  
  309. v0.02 - December 31, 1995.
  310.  
  311. This is the first "public" release.  Here's a list of bug fixes and changes
  312. from the earlier ßeta version..
  313.  
  314. -Configuration!  You can design your own listing format!
  315. -Added file-locking so now multi-line BBSs can use DCTCall too ;)
  316. -DCTCall now has full ANSI and ASCII support.
  317. -The colours were changed a bit so they're brighter...people complain that
  318.  my designs are always so dull.
  319. -The program should should run a bit faster now.
  320. -The program now calls its configuration files from the directory that it
  321.  resides in rather than the current directory (well it still checks the
  322.  current dir, but will check its home directory if they're not in the current
  323.  one).
  324.  
  325. ßeta 1 - October 7, 1995.
  326.  
  327. Initial creation.  Not too many configuration options or anything.
  328.  
  329.  
  330.  ▒▄▄▓▄▄▄▄▄█▄ ▄▄ ▄▄▄▓▄▄▄▄▄▄ ▄▓▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▓▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▓▄▄▄▄▄▓▄
  331.   ▀▀  ▀▀▓ ▀▀▀▓▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▓▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▓▀▄▒▀
  332.                                     {EoF}
  333.